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Data Storage on 
CompactFlash (CF) Cards 


using BASCOM AVR 


By F-J. Vogel 


In this article we show you how BASCOM AVR enables the Compact 
Flash Interface for our 89S8252 Flash Micro Board to be employed for 
DOS-compatible data storage in systems based on AVR microcontrollers. 


The author’s aim was to be able to use the 
Compact Flash Interface on an Atmel devel- 
opment board (RIBU ATMEGA103 Test Board) 
as well as in combination with BASCOM-AVR 
software, taking into account that the Atmel 
Test Board does have a lot of port lines, but no 
CPU-ish pins like RD, WR and ALE which are 
normally needed to connect external RAM. 
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Figure |. Connecting the Elektor CF Interface 
to an AVR microcontroller system. 
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Compact Flash interface 
As shown in Figure 1, the hardware- 
wise connection to a microcontroller 
is possible without ‘major surgery’. 
The eight datalines DO through D7 
are taken to a controller port. The 
remaining control lines occupy six 
pins of a further port. Address lines 
AO, A1 and A2 are connected to pins 
0, 1 and 2. The WR (write) and RD 
(read) lines are connected to pins 3 
and 4 of the control port. The chip 
enable input of the CompactFlash 
card is addressed by way of an 
address decoder, which pulls CE1 
low when an address within the 
range F000 - FFFF is applied in 
external RAM mode. 

However, using the solution pro- 
posed here, the CE1 input will have 
to be activated by a dedicated out- 
put pin. To this end, pin 5 of the con- 
trol port is taken to A12 (an input of 
the NAND gate). The remaining the 
inputs A13, A14 and A15 of the 
NAND gate are tied to V,,, so that 
outputting a High level at CE causes 
the output of the NAND gate to 
change from High to Low, thereby 
activating the CF card. The process 
as outlined above requires a total of 
14 CPU I/O pins. Because the CF 
card is only activated through the CE 
input, at least a part of the other 
‘occupied’ pins is available for use in 


combination with additional periph- 
erals like an LCD. 


Compact Flash drivers 


A software driver for a Compact- 
Flash card should be able to read 
and write sectors of 512 bytes each, 
as well as initialise all required I/O 
pins (port lines). In as far as the 
interface is not capable of perform- 
ing its own Power-On Reset, the dri- 
ver should look after the resetting of 
the CF card. Also, the software 
should be able to establish whether 
the CF card in the system is avail- 
able or not. Summarizing, the dri- 
ver’s functionality for a CF card or 
another storage medium (Smart- 
Card, MultiMedia card) boils down 
to these routines: 


DriveReadSector 

Read a sector. 
Drive WriteSector 

Write a sector. 
DriveReset 

Reset a storage device. 
DrivelInit 

Initialise the CPU peripherals 
including a reset for the storage 
device. 
DriveCheck 

Check if the storage device is 
available fand ready for access. 
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Figure 2. The application reads and 
writes individual CF card sectors. 


DriveGetldentify 
Read the CF card's internal parame- 
ter blocks. 


The names printed in bold type are 
the labels of the functions imple- 
mented in the current version of 
BASCOM-AVR. Explanations of the 
call parameters as well as exact 
function descriptions may be found 
in the Help file [1], which may be 
downloaded free of charge from the 
MCS Electronics website. Prices of 
CF cards having plummeted these 
past few months (a 128 MB card will 
now set you back less than 35 
pounds), these software functions 
allow you to add an enormous 
amount of storage capacity to your 
microcontroller system. 

If the data are to be copied onto a 
PC system for processing at a later 
time, the question arises how it 
should be organised on the Flash 
card to ensure compatibility 
between the microcontroller and the 
PC. If the MCU continuously writes 
data into the card's sectors, the PC 
program is forced to read the card 
sector by sector and by way of an 
adapter, interpreting the data all the 
time. 

Another possibility is to use the 
PC to write a largish file containing 
nothing but blank data to a freshly 
formatted CF card. This would 
require the microcontroller to write 
its data line by line in ASCII format 
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Figure 3. The application reads and 
writes DOS files. 


into the occupied sectors. Once the 
data storage process is finished, the 
PC would be able to read the data 
under the previously given file name, 
using, for example, Excel. In any 
case, special programs would not be 
required. 

The third and by far most elegant 
method is represented by a DOS sys- 
tem for BASCOM-AVR. Such a sys- 
tem puts all functions like creating, 
opening, reading and writing files in 
ASCII as well as binary format at the 
disposal of the microcontroller sys- 
tem, using a DOS formatted CF card. 


DOS File System 


The development of a DOS file sys- 
tem for BASCOM-AVR first started 
with an Internet search for informa- 
tion describing the way DOS and 
Windows manage files on a hard 
disk. A few very extensive and 
graphically well-presented websites 
were found [2]. In some cases, how- 
ever, the information presented on 
the sites did not reflect personal 
experience, while in other cases dis- 
crepancies were found between cer- 
tain bits of information. At the end of 
the day, the author found Microsoft's 
Extensible Firmware Initiative, 
FAT32 File System Specification [3] 
the most authoritative source. The 
document not only originates from 
the inventors of the DOS file system, 
but also was also found to contain 


valuable information on data formats for use in 
embedded systems. Despite the document’s 
title, FAT12 and FAT16 are also covered in 
depth. 

During the further development of the pro- 
ject, the following essential points were 
noted: 


DOS FAT16 File System 

DOS FAT16 is the standard file system for 
storage volumes from 32 MB up to 512 MB, 
the theoretical limits ranging from 2 MB to 
4 GB, covering the complete range of cur- 
rently available CF cards. FAT12 and FAT32 
pose heavier demands in terms of cluster 
management within the FAT. 


Short DOS names (8.3 format) 

Broadly speaking, a microcontroller system 
will not have the resources (i.e., input/output 
devices) to enable long file names to be han- 
dled with ease. Consequently a restriction to 
short file names only is unlikely to cause 
major problems, if you know that existing 
long file names may be addressed by means of 
their alias. 


Files in Root Directory only 

Using the standard formatting method, the 
Root directory is able to manage 512 files. 
This, we feel, should be sufficient for most, if 
not all, microcontroller systems, even really 
big ones. On the CF card, files may be stored 
in subdirectories, although they cannot be 
opened from there. 


Sector size 512 bytes 

Because the CF card can only transfer data on 
a sector-by-sector basis, and the sector size 
is a direct factor in the SRAM size require- 
ments, AVR-DOS was designed for the stan- 
dard sector size of 512 bytes, although other 
sizes like 1 kB, 2 kB, 4 kB and so on are sup- 
ported by the Microsoft operating systems. 


LBA sector addressing 

The sector addressing on the CF card 
employs LBA Mode (Logical Block Address), 
which means that each sector is assigned a 
unique, linear address. The C/H/S (Cylin- 
der/Head/Sector) method used in the early 
days of the hard disk is not supported. The 
file system was entirely written in AVR 
assembly code. 


Configuration options 


The DOS system is configurable with regard 
to the number of files that can be open at the 
same time. The open files are managed using 
file handle buffers. Besides the actual sector 
buffer, these contain the file number, directory 
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pointer and cluster number, and have a size of 
534 bytes each. The number of possible file 
handles thus depends on the available RAM 
space and may be extended (if necessary) 
with external RAM. The DOS system contains 
measures to ensure a file can be opened mul- 
tiple times in read mode (INPUT) only. 
Attempts at opening file several times over in 
read or write mode are signalled and rejected. 

One further configuration option concerns 
the way the directory and FAT information is 
processed. This information may be saved 
either in a common buffer (saving RAM space 
and allowing faster file handling), or is sepa- 
rate buffers. In the second case, the sector is 
already saved in RAM when access is 
changed from FAT to Directory or the other 
way around, obviating the need to reload 
data from the CF card. 


Implementation 
in BASCOM-AVR 


The routines developed were integrated into 
the latest version of BASCOM-AVR in such a 
way that they can be called from an applica- 
tion using the syntax familiar from QBA- 
SIC/VBA/VB when it comes to file handling. 
This allows data input/output routines writ- 
ten in one of these dialects of BASIC to be 
copied and used without too many problems. 
The implemented commands listed in the 
Table show that size largely exceeds the min- 
imum requirements for data logging 

Unfortunately, a detailed discussion of all 
commands is beyond the scope of this article, 
although we should hasten to add that all you 
might want to know on the subject of com- 
mand functionality may be found in the Help 
file [1]. 

Two simple examples should help to pro- 
vide insight into the workings of the AVR- 
DOS system. Example 1 shows how the val- 
ues at three A/D inputs are logged over a 
period of about ten hours. First, the file sys- 
tem is initialised. Only if BASCOM-AVR was 
able to read the file system, the program 
returns ‘0’ as an Error Code. The value ’0’ 
generally indicates that the DOS routine was 
able to complete its function as expected. 

In Example 2, five command lines are 
used to read the ‘contents page’. All files with 
the extension ‘DAT’ are looked up and their 
file names, dates, modification dates and file 
lengths get copied to the serial output line 
using the PRINT command. 


Simulation 


The BASCOM package contains an easy to 
use Simulator which allows a newly written 
program to be run on the PC before flashing 
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HAYR Simulator 
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if gbInp <> 0 then | 
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Figure 4. Screendump showing Example 2 being run in the AVR Simulator. 


Example |. Recording the values supplied by A/D converters 


Dim bError as Byte 
Dim wValuel as Word , wValue2 as Word , wValue3 as Word 
Dim wsecond as Word 


‘ initialise file system 

bError = InitFileSystem(1) 

If bError <> 0 then 
Print “No valid file system found” 
End 

End If 


‘ Configure and start AD converter 
Config ADC = Single , Prescaler = Auto 
Start ADC 


‘ Create file to write 
Open “AD1.txt” For Output As #10 
For wSecond = 1 to 36000 ‘ seconds counter for 10 hours 


wValuel = GetADC(1) ‘ 1. read analogue value 
wValue2 = GetADC(2) ‘ 2. read analogue value 
wValue3 = GetADC(3) ‘ 3. read analogue value 


‘use seconds counter to write values into file 
Write #10 , wSecond , wValuel , wValue2 , wValue3 
Wait 1 ‘ wait 1 second 

Next 

Close #10 

End 


Example 2. Contents page of a CF card. 


Dim strFileName as String * 12 


strFileName = Dir(”*.dat”) ‘ 1. Find file 
While strFileName <> “" ‘ File found? 
Prines tr eieNamne p 7 % 9 isulepeea()) p E TE) y 
“u ; FileLen() 
strFileName = Dir() ‘ find next file 
WEnd 
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[1] BASCOM-AVR Help file 
www.mceselec.com/download/avr/beta/bas' 


html.zip 





[2] Information on DOS FAT 


www.beginningtoseethelight.org/fat | 6/index.php 





www.win.tue.nl/~aeb/linux/smartmedia/ S 


martMedia_Format.pdf 





[3] Microsoft Extensible Firmware Initiative, FAT32 File System Specification 


http://www.microsoft.com/hwdev/download/hardware/FATGEN 103. doc 


it. The CF card also allows this to be 
done — in a way. This was achieved 
with the aid of a driver simulating a 
CF card (admittedly with just 59 kB 


and a largest directory size of just 16 
files) in the AVR’s extended RAM 
range. To this end, a so-called XRAM 
Driver is linked instead of the normal 


CF card driver. Here, too, the modular driver 
concept pays off because it allows storage 
media to be swapped by changing a single 
statement. This not only allows the behaviour 
of application software in a DOS environment 
to be tested, but also the actual data storage 
on a storage medium in the external RAM 
range. According to the Microsoft recom- 
mendations, a disk size of 59 kB should be 
managed using FAT12 (up to 4 MB) and not 
FAT16. However, as this ‘partition’ is virtual 
only and intended for test purposes, this 
departure from the rules remains without 
negative consequences. 

(030169-1) 
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Table |. Command List 


e GetFileSystem 


e DISKSIZE 

e DISKFREE 

e KILL <FileName> 

e DIR({<FileName>]) 

e FILELEN([<FileName>]) 

e FILEDATETIME([<FileName>]) 


e FILEDATE +» ([<FileName>]) 
e FILETIME +) ((<FileName>]) 


File creation, opening, writing and reading 


Reads required data from Master Boot Record (MBR) and Partition Boot Record 
(PBR) of the CF card in order to initialise the file system (not contained in QBA- 
SIC/VBA/VB syntax). 

Overall CF card storage capacity in bytes. 

Available CF card storage capacity in bytes. 

Wipes a file from CF card. 

Searches for the first or second matching file name on the CF card. 

Size of a file in the Root directory matching file name or file last found using DIR. 
Date and time of a file in the Root directory matching file name or file last found 
using DIR. 

Date of a file in the Root directory matching file name or file last found using DIR. 
Time of a file in the Root directory matching file name or file last found using DIR. 


e Open <FileName> FOR INPUT/OUTPUT/APPEND/BINARY AS #<File#> Opens/creates a file at INPUT in read mode, at OUT- 


e FREEFILE() 
e CLOSE <File#> 
e FLUSH [<File#>] 


e PRINT #<File#> , Variable! ; Variable2; ... 


e WRITE #<File#> , Variable! , Variable2, ... 


e INPUT #<File#> , Variable! , Variable2, ... 


e LINE INPUT #<File>, StringVariable 
e GET #<File#>, <Variable> [, Position] 


e PUT #<File#>, <Variable> [, Position] 
e SEEK #<File#> [,<New Position>] 


Status information on opened files 
e EOF #<File#> 

e LOC #<File#> 

e LOF #<File#> 

e FILEATTR #<File#> 


Miscellaneous 
e BLOAD <FileName>, <SRAM Address> 


PUT/APPEND in write mode, at BINARY in read/write mode. 

Returns a free file number, this may be used for the OPEN functions. 

Closes a file and releases the file handle. 

Writes the current data buffer(s) into RAM on the CF card and updates the con- 
tents (not contained in QBASIC/VBA/VB syntax). 

Writes data in text format into a text file that was opened with OUTPUT or 
Append 

Writes data in text format into a text file that was opened with OUTPUT or 
Append. Individual data files are separated with a comma and character strings are 
enclosed in quotation marks. 

Reads data from a from a text file into program variables, mostly data written into a 
file using a WRITE command. Data files to be comma-separated and character 
strings enclosed in quotation marks if they contain commas. 

Reads a line from a text file into a string character variable. 

Reads binary format data into any program variable from a file opened in BINARY 
mode. 

Writes any program variable in binary format into a file opened in BINARY mode 
Returns the file position of the next read/write access. The additional parameter 
<New Position> allows the position to be changed with files in binary mode also. 


Returns the status End of File. 

Indicates the file position of the last read/write access. 
Indicates the file length. 

Returns file opening mode. 


Writes the contents of a microcontroller RAM range, starting at SRAM address. 


e BSAVE <FileName>, <SRAM Address>, <Length> Saves a microcontroller RAM range into a file. 
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